Document structure

General A standard written using the iso style must obey certain rules, as follows:

The first non-comment line must be
```
    \documentstyle{iso}
```
This must be followed by two lines giving the number and title of the standard, as follows:
```
    \standard{1234}
    \title{A standard for egg-sucking}
```
$\begin{note} % latex2html id marker 38An optional version number may also be ... ...d above, \verb\vert\theversion\vert gives \version{1.6.4}\theversion. \end{note}$
Any user-defined LaTeX macros should follow the standard number and title. There should then follow the begin document command:
```
    \begin{document}
```
Then come the tables of contents (optional, see $[*]$ ), foreword (optional, see $[*]$ ), introduction (optional, see $[*]$ ) and title commands. The title command is written thus:
```
    \maketitle
```
The structure of the rest of the document is described in $[*]$ . The document must finish with
```
    \end{document}
```

See annex $[*]$ for an example standard.

Divisions and subdivisions

Names of divisions and subdivisions The iso style permits a document to be made up of the following divisions: part, section, clause, subclause, subsubclause, subsubsubclause.

Each type of division is introduced in the normal LaTeX manner by a command, whose name is that of the division type, and a parameter which is the title of the division. For example:

\section{A typical section}
\clause{This is a clause}
\subclause{Winds light to variable}
\subsubclause{The famous Eccles}
\subsubsubclause{The Greenslade story}

Each division generates a corresponding entry in the table of contents (see $[*]$ ). Starting a new division causes all subsidiary division numbers to start again from zero (e.g. starting a clause resets the subclause, subsubclause and subsubsubclause numbers to zero).
$\begin{note} This is a change from ordinary \LaTeX\ in which starting a division... ... and not those at lower levels --- I regard this as a bug in \LaTeX . \end{note}$

There are also untitled versions of subsubclause and subsubsubclause introduced by \namelesssubsubclause and \namelesssubsubsubclause respectively. These have run-in headers and do not produce entries in the table of contents.

Finally there is the lowest level of division: the paragraph. This is unnumbered and untitled and introduced by either \par or a blank line.

Special divisions Tables of contents Tables of contents are produced in the usual LaTeX manner, using \tableofcontents, \listoffigures and \listoftables. These should come before the \maketitle, see $[*]$ .
$\begin{note} If you find the table of contents too detailed, you can reduce the ... ...gives a table of contents with entries only down to the clause level. \end{note}$

Foreword The foreword to a standard appears after the tables of contents and is unnumbered. For this reason, it uses a special macro as follows:

\foreword

In fact, the foreword to a standard is set by ISO central secretariat so it should not usually be necessary to include one in your documents.

Introduction The introduction to a standard appears after the tables of contents and the foreword and is unnumbered. Like the foreword, it uses a special macro:

\introduction

References The references section contains titles of normative documents to which reference is made in the body of the standard. The references section is constructed as follows:

\section{References}
\begin{references}
\bibitem[ISO 8879]{sgml} Information processing ---
    Text and office systems --- Standard
    Generalised Markup Language (SGML).
\end{references}

The output from this is shown in section $[*]$ .

The second argument of the \bibitem command is a label which is used in citing the document. For instance, \cite{sgml} gives the output [#!sgml!#].
$\begin{note} If the first text in a paragraph is \verb\vert\cite\vert, then the paragraph will start in the wrong place. This is a LaTeX bug. \end{note}$

Definitions A definition is numbered in the same way as a clause but has a run-in header and does not appear in the table of contents; see section $[*]$ for examples. A definition is entered as follows:

\definition{term} Text of definition...

$\begin{note} Definitions and clauses should not appear in the same section since they are numbered independently of each other. \end{note}$

Annexes The main body of a standard may be followed by annexes, each of which is either normative or informative. The first annex should be preceded by the \annex command. Normative annexes are then introduced by the command:

\normative{Annex title}

while informative annexes are introduced by the command:

\informative{Annex title}

Annexes may be divided into clauses, subclauses etc in the same way as sections; the only difference is that annexes are numbered using upper-case letters rather than Roman numerals.
$\begin{notes} \item Users who are using the {\tt iso\/}\ style for documents oth... ...e command: \begin{verbatim}\addtocounter{section}{1}\end{verbatim} \end{notes}$